Programming with QuickTime VR

| Previous | Chapter contents | Chapter top | Section top | Next |

QTVRPtToHotSpotID

You can use the QTVRPtToHotSpotID function to get the ID of the hot spot, if any, that lies beneath a point.

OSErr QTVRPtToHotSpotID (QTVRInstance qtvr, Pointpt, UInt32*hotSpotID);
qtvr
An instance of a QuickTime VR movie.
pt
A point, in the local coordinates of the graphics world of the specified movie.
hotSpotID
On entry, a pointer to a long integer. On exit, that long integer contains the ID of the hot spot that lies beneath the specified point, or the value 0 if no hot spot lies beneath that point.
function result
A result code.

DESCRIPTION

The QTVRPtToHotSpotID function returns, in the long integer pointed to by the hotSpotID parameter, the ID of the hot spot in the QuickTime VR movie specified by the qtvr parameter that lies directly under the point specified by the pt parameter. If no hot spot lies under that point, the long integer is set to 0.

© 1997 Apple Computer, Inc.

| Previous | Chapter contents | Chapter top | Section top | Next |